Setting Properties for Controls, Regions, and App Palettes

This topic describes the procedure to define the properties of a UI element.

After adding a control, region, or App Palette to an XForm, you can modify it to achieve the required run-time behavior. To do so, you need to specify appropriate properties and events in its property sheets.

Each control is associated with a Basic Properties App Palette where you can set basic properties and aproperty sheetwhere you can set advanced properties for the control.

1. Open the XForm in the XForms Designer.
2. Select the control in the Designer Area. The icon appears on the top right corner of the selected control. This icon appears only for the current control that you have selected.
3. Click . The Basic Properties App Palette appears.
4. Make appropriate modifications in the Basic Properties App Palette.
   • ID: Enter the ID of the control.
   • Class: Enter the name of the style class to be applied to a control.
   • Height: Enter the height of the control to set its size at run time.
   • Width: Enter the width of the control to set its size at run time.
   • Position: Select the position of the control. For details, see Positioning Controls.

     Note:

     • For the Input, Password, Output, Check, Radio, Select, Text, and Frame controls, Height is set to auto and is disabled.
     • In a Vertical layout, the width is set as 100% for all controls, by default.
     • In a Horizontal layout, the width is set as 44% for all controls, by default.
     • You can set the Height and Width in pixels (px), points (pt), em, ex, millimeters (mm), centimeters (cm), inches (in), and percentages (%).
5. Right-click the control, and select Properties. Alternatively, double-click the control. The <control name> window appears, displaying various collapsible panes, where you can specify the required properties and events.
6. Make the appropriate modifications in the <control name> window.
7. Click .
   The properties specified for the control, region, or App Palette are saved.
   For information about the properties, Web service operations, and events associated with an interface element, see XForms API. You can use the Message Map for associating data with the events of a control. For details, see Using Message Map.

   Note:
   You can view and specify properties for controls, toolbar buttons, element bar buttons, and also for the XForm as a whole. For details, see Property Sheet of Controls, Regions, and App Palettes and Setting Properties of an XForm.